# 登录（前置条件；也可用各网络子命令的 --token/--endpoint 覆盖）
ms login --token <your-token>

# 上传本地 agent 文件到远端仓库
#   必填：-f/--framework、-r/--repo
#   可选：-n/--name、--local-dir、--visibility {public,private}（默认 public）、--dry-run、--token、--endpoint
ms-agent agent upload --framework qwenpaw --repo user/my-agent
ms-agent agent upload --framework nanobot --repo user/my-agent --name reviewer \
    --local-dir ./ws --visibility private --dry-run --token <token> --endpoint <url>

# 从远端下载 agent 文件到本地
#   必填：-f/--framework、-r/--repo
#   可选：-n/--name、--local-dir、--target-framework、--dry-run、--token、--endpoint
ms-agent agent download --framework qwenpaw --repo user/my-agent
ms-agent agent download --framework nanobot --repo user/my-agent --name reviewer \
    --local-dir ./ws --target-framework qwenpaw --dry-run

# 后台同步守护进程（默认 push-only）
#   必填：-f/--framework、-r/--repo
#   可选：-n/--name（默认全部 agent）、--local-dir、--pull（双向同步）、--token、--endpoint
ms-agent agent watch --framework qwenpaw --repo user/my-agent
ms-agent agent watch --framework qwenpaw --repo user/my-agent --name reviewer \
    --local-dir ./ws --pull

# 停止 watch 守护进程（无参数）
ms-agent agent stop

# 查看本地状态
#   必填：-f/--framework    可选：--local-dir
ms-agent agent status --framework qwenpaw --local-dir ./ws

# 格式转换（纯本地，无网络）
#   必填：--from-framework、--target-framework
#   可选：--from-name（默认 default）、--target-name（默认同 --from-name）、--local-dir、--out-dir、--dry-run
ms-agent agent convert --from-framework nanobot --target-framework qwenpaw
ms-agent agent convert --from-framework nanobot --target-framework qwenpaw \
    --from-name default --target-name reviewer --local-dir ./src --out-dir ./out --dry-run

# 备份管理
#   backups  可选：-f/--framework、-n/--name、--local-dir
#   restore  必填：--from-backup（'last' 或具体备份文件名）    可选：-f/--framework、-n/--name、--local-dir
ms-agent agent backups --framework qwenpaw --name reviewer
ms-agent agent restore --from-backup last --framework qwenpaw --name reviewer --local-dir ./ws

# 列出远端仓库（代码已实现，但尚未 GA，未写入用户文档）
#   可选：--owner、--page（默认 1）、--page-size（默认 10）、--token、--endpoint
ms-agent agent list --owner user --page 1 --page-size 20